注英 ZhuEn
安裝與操作指引

版本 0.2.0 · macOS 14 以上 · 通用執行檔（Apple Silicon＋Intel）

目前交付為開發測試版，已建置兩種晶片架構，但 Intel 實機及跨 App 相容性尚未全部驗收。未簽署／未公證的 testing 安裝包不是正式公開發行版。請依安裝包實際簽署與公證狀態判斷；不要關閉 Gatekeeper 或移除 quarantine 來略過安全檢查。

1. 安裝

下載並解壓縮注En 安裝器，點兩下 ZhuEn Installer.app。
在首頁按「安裝／更新」。已有版本會直接更新。
完成後先閱讀同一視窗中的操作指引。
按說明第一步旁的「開啟系統設定」，到「鍵盤 → 文字輸入 → 編輯 → ＋ → 繁體中文」加入「注En」；已加入可略過。系統設定只會在點此按鈕後開啟，不會自動跳出。
從選單列切換到「注En」，按右下角「完成」關閉安裝器。

不需要預先切換 ABC 或登出。輸入法安裝在 ~/Library/Input Methods/ZhuEn.app。

2. 更新

開啟新版安裝器，按「安裝／更新」。保留設定、學習資料及快捷文字；使用中更新保留組字，必要時另提示重新載入方式。

3. 基本輸入

按鍵	作用
`su3cl3`	大千注音輸入「你好」，Enter 送出
空白	未完成音節時組一聲；音節完成後插入空格
↓／右鍵	開候選（右鍵仍需各 App 實測）
↑ ↓、1–9	橫向候選用 ← → 選字；再按 ↓ 或點箭頭展開更多。展開後 ↑ ↓ 換列，數字選本頁；Page Up／Down 翻頁
← →	在尚未送出的句子中移動、插入或改字
Backspace	先修正目前音節，再刪除組字
Enter	送出組字，套用已啟用的排版規則
Esc	先關候選，再清未完成音節或整段組字
Shift 單擊	切換中英；英文接續段中則回中文
Shift＋字母	開始明確英文段，保留實際大小寫
Tab	接受英文提示

明確英文、數字可接在中文組字內：gmailsu3cl3 → gmail你好。尚有歧義時請開候選選擇。相同注音可能對應不同詞，並非每個句子都能首次辨識正確。

4. 設定

選單列「注En → 設定」，也可從安裝器首頁按「輸入法設定」。選單只提供「設定」與「使用說明」；macOS 自動附加的系統項目仍由系統管理。

一般：Shift 單按切換中英、標點樣式與候選數。Caps Lock 切到 ABC 由 macOS 鍵盤設定控制。
文字與空格：分別開啟中文／英文／數字之間的空格，按 Enter 送出時套用；文字替換改用 macOS「系統設定 → 鍵盤 → 文字替換」，注En 不再提供自訂大小寫或替換功能。
進階：英文候選、自動辨認英文；管理常選字與學習資料。

組字時閃爍細線表示插入位置，左右鍵可移動；線條高度與粗細依輸入欄位的原生游標尺寸。游標獨立繪製，不插入文字記號，也不重寫組字來製造閃爍。中文模式的單一斜線／句點仍是注音鍵，可按 ↓ 選英文符號；連按句點可輸入 ...。

5. 個人資料與離線使用

日常輸入無需帳號、啟用碼或網路。學習檔：~/Library/Application Support/ZhuEn/userphrases.json；快捷文字：同資料夾的 customtexts.json。一般設定與自訂英文詞彙保存在 org.zhuen.inputmethod.ZhuEn 的 macOS UserDefaults。版本更新不清除這些資料。

6. 解除安裝

完成正在輸入的文字，切換到其他輸入來源。
開啟注En 安裝器，按首頁的「解除安裝」並確認。

解除安裝保留個人設定、學習資料及快捷文字。使用中的注En 不會被強制終止。

7. 問題排除與回報

找不到輸入來源：確認安裝位置，重新開啟鍵盤設定，從繁體中文加入注英。若仍未出現或更新未生效，可在儲存工作後嘗試重新登入；這不是必要安裝步驟。
只輸出英文字母：確認選單列已選注英、Caps Lock 關閉，Shift 單擊回中文。
詞彙不準：按 ↓ 選字後送出，學習會影響下次排序；可刪除不適合的學習資料。
某 App 行為異常：記錄 macOS／App／注英版本、按鍵順序、預期與實際文字，特別標記選字、Undo、失焦、換行或滑鼠操作。

已完成核心自動測試與通用架構建置不等於所有 App 相容性已通過。Safari、Chrome、VS Code、Terminal、Notes、Slack／Teams、Pages／Word，以及 Intel 實機仍需依測試記錄完成驗收。

注英 ZhuEn安裝與操作指引